home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / satellit / predict / readme < prev    next >
Text File  |  1994-04-30  |  11KB  |  232 lines
  1.  
  2.  
  3.          ╔═════════════════════════════════════════╗
  4.          ║  Satellite Orbital Prediction Software  ║
  5.          ║          By John A. Magliacane          ║
  6.          ║  «  KD2BD Software - Copyright 1994  »  ║
  7.          ╚═════════════════════════════════════════╝
  8.  
  9.                           
  10. * INTRODUCTION *
  11. ----------------
  12. PREDICT is a satellite orbital prediction program written in 'C' for the 
  13. MS-DOS operating system by John A. Magliacane, KD2BD in 1994.  It was 
  14. designed specifically to assist in Amateur Satellite communications, and 
  15. contains features useful in making visual observations of larger satellites.  
  16.  
  17. PREDICT was originally designed to run on a 1 MHz Commodore 64 computer
  18. in 1992.  As a result, the orbital tracking and prediction algorithms 
  19. contained in PREDICT have been optimized for high speed operation.  During 
  20. its development, the program crossed over from the C64 environment to 
  21. several multi-user Unix and SunOS platforms, and then finally over to 
  22. MS-DOS.  This version issued in 1994 is menu driven and supports a mouse.
  23.  
  24.  
  25. * CONDITIONS OF USE *
  26. ---------------------
  27. The files contained in this software package are the property of John A. 
  28. Magliacane, copyright 1994.  You are welcomed to share this software with 
  29. others provided it is distributed in a complete and unmodified form and 
  30. that no fee or other consideration is charged or accepted.  You are granted 
  31. the right to use this software for non-commercial purposes without further 
  32. permission.  Commercial use of PREDICT without the expressed written 
  33. permission of the author is strictly forbidden.  John A. Magliacane, the
  34. author of this software, shall not be liable in any way for any damages
  35. arising out of the proper or improper use of this software or its related
  36. files.
  37.  
  38.  
  39. * GETTING STARTED *
  40. -------------------
  41. The main program menu of PREDICT provides the following program options:
  42.  
  43.     [F1]  : Predict Satellite Passes
  44.     [F2]  : Auto Update Keplerian Data Base
  45.     [F3]  : Keyboard Edit Of Data Base
  46.     [F4]  : Satellite Orbital Information
  47.     [F5]  : Ground Station Information
  48.     [?]   : Help!
  49.     [ESC] : Exit Program
  50.  
  51. The satellite ground station callsign and geographical location information 
  52. may be entered using the [F5] editing utility.  Ground station location
  53. should be entered in decimal degrees north latitude (south is entered as 
  54. negative), and decimal degrees west longitude.  Your altitude above ground 
  55. should be entered in meters.  The hour differential between your system
  56. clock and UTC should also be entered.
  57.  
  58. All satellite programs require current Keplerian data for the satellites
  59. of interest to the ground station operator.  PREDICT holds orbital data
  60. for 21 of your favorite satellites.  Keplerian data is available from a 
  61. variety of sources in several different formats.  The most popular is the 
  62.  
  63.  
  64. "NASA 2-line" format.  This format is available through NASA and AMSAT 
  65. information sources on packet radio, telephone BBSs, and the Internet.  
  66. It contains the satellite name on a single line followed by two lines of 
  67. orbital data.  Redundancy is incorporated into this format through the use 
  68. of a modulo 10 checksum digit on the end of each line:
  69.  
  70. MIR
  71. 1 16609U 86017A   94111.21750077  .00004090  00000-0  58434-4 0  5749
  72. 2 16609  51.6453 111.7160 0015230 167.5089 192.6283 15.58719614467153
  73.  
  74. PREDICT's "Auto Update" [F2] mode accepts orbital data in this form contained
  75. in an ASCII text file and verifies the data against the checksum digits to
  76. insure accuracy.  It links object numbers between the 2-line element file
  77. and the predict.dat file when the "Auto Update" program option is chosen.
  78. This allows the user to label a satellite with a different name than what
  79. is indicated in the 2-line element file.
  80.  
  81. When auto updating orbital data from a 2-line element source file, PREDICT
  82. rejects all extraneous ASCII text, mail headers, etc., that may come either
  83. before or after valid 2-line element data.  In addition, it will only update 
  84. from Keplerian data that has a reference epoch time equal to or greater than 
  85. the data currently held in the predict.dat file.
  86.  
  87. Keplerian orbital data may also be entered through the keyboard using the 
  88. keyboard editing utility [F3].  In either case, the satellite program keeps 
  89. the old Keplerian data file as a back-up (predict.old).
  90.  
  91. Orbital data can be entered, changed, or edited manually using the [F3]
  92. program option.  New satellites can be added to PREDICT's orbital data
  93. base by entering the new data into the program using the [F3] option.
  94. This can be done automatically if a NASA 2-line element file is available.
  95. Simply enter the satellite name and object name manually using the [F3]
  96. utility.  Accept the old orbital data by pressing ENTER at each line, then
  97. run the "Auto Update" function [F2], and the orbital data for the new
  98. satellite will be added to PREDICT's data file.
  99.  
  100. Once the program is loaded with Keplerian data and the ground station
  101. location, it is ready to run.
  102.  
  103.  
  104. * SATELLITE ORBITAL PREDICTION *
  105. --------------------------------
  106. The satellite orbital prediction mode begins by prompting the user for a 
  107. satellite selection from a list of 21 satellite names:
  108.  
  109.  
  110.     [A]: OSCAR-10           [H]: OSCAR-20           [O]: OSCAR-27
  111.  
  112.     [B]: OSCAR-11           [I]: RS10/RS11          [P]: MIR      
  113.  
  114.     [C]: OSCAR-13           [J]: RS12/RS13          [Q]: UARS
  115.  
  116.     [D]: PACSAT             [K]: RS14/AO21          [R]: NOAA-9
  117.  
  118.     [E]: DOVE               [L]: OSCAR-22           [S]: NOAA-10
  119.  
  120.     [F]: WEBERSAT           [M]: OSCAR-23           [T]: NOAA-11
  121.  
  122.     [G]: LUSAT              [N]: ITAMSAT            [U]: NOAA-12
  123.  
  124.  
  125.  
  126.  
  127. Selection can be either via the keyboard or by clicking the mouse on
  128. the satellite name displayed on the screen.  The user is prompted for
  129. a starting date and time to begin the orbital prediction calculations.  
  130.  
  131. The starting time must be entered in UTC using the format: 
  132.     
  133.      DDMonYR HH:MM:SS
  134.  
  135. such as: 01May94 02:00:00
  136.  
  137. The default starting date and time is the current date and time and may be
  138. accepted simply by pressing the [ENTER] key and not entering any time.
  139.  
  140. If the satellite is in range at the time entered, PREDICT will move back                      
  141. in time to find the time of AOS, and start printing an orbital calendar
  142. starting at AOS.  Tracking data is displayed one screen at a time.  A typical
  143. satellite pass might look something like this:
  144.  
  145.               KD2BD's Orbit Calendar For RS14/AO21
  146.      Date     Time    El   Az  Phase  Lat   Long    Range   Orbit
  147.     -------------------------------------------------------------
  148.     01May94 02:01:08   0  172   110    10     70     3659   16311
  149.     01May94 02:02:58   7  169   114    16     69     2982   16311
  150.     01May94 02:04:47  16  165   119    22     69     2328   16311
  151.     01May94 02:06:33  28  158   123    28     68     1745   16311 +
  152.     01May94 02:08:10  45  140   127    34     68     1325   16311 +
  153.     01May94 02:09:29  56  103   130    38     67     1159   16311 +
  154.     01May94 02:10:31  54   64   133    42     67     1191   16311 +
  155.     01May94 02:11:36  42   39   135    45     66     1371   16311 +
  156.     01May94 02:12:58  29   26   139    50     65     1734   16311 +
  157.     01May94 02:14:35  17   18   143    55     64     2262   16311 +
  158.     01May94 02:16:20   8   14   147    61     62     2888   16311 +
  159.     01May94 02:18:08   1   12   151    67     58     3558   16311 +
  160.     01May94 02:18:36   0   11   153    68     57     3731   16311 +
  161.  
  162. The information displayed is defined as follows:
  163.  
  164. Date  : Date in UTC
  165. Time  : Hours, minutes, seconds UTC in 24 hour format
  166. El    : Satellite elevation above the ground station horizon in degrees
  167. Az    : Satellite azimuth heading (North = 0 degrees)
  168. Phase : Modulo 256 orbital counter.  Perigee = 0, Apogee = 128
  169. Lat   : Sub-satellite point latitude in degrees North
  170. Long  : Sub-satellite point longitude in degrees West
  171. Range : Distance between the satellite and the ground station in kilometers
  172. Orbit : Orbit number.  Number of perigees that have occurred since launch
  173.  
  174. A '*' symbol at the end of the line indicates the satellite is in sunlight.  
  175. A '+' symbol indicates it is in sunlight while the ground station is in 
  176. twilight.  Some larger satellites are visible under these conditions as 
  177. reflected sunlight causes them to appear as "stars" moving across the sky.
  178. If the end of the line is blank, the satellite is not in sunlight.
  179.  
  180. Each screen is concluded with the prompt:
  181.  
  182.     More? [y/n] >> 
  183.  
  184.  
  185.  
  186. Entering the letter 'n', hitting the ESCAPE key, or clicking the right 
  187. mouse button ends the orbital prediction calculations, while entering a 
  188. 'y', pressing the ENTER key, the space bar, or clicking the left mouse 
  189. button causes the program to advance to the next screen of orbital 
  190. predictions.
  191.  
  192.  
  193. * LOGGING SCREEN OUTPUT TO A FILE *
  194. -----------------------------------
  195. A screen logging feature is available in PREDICT and is activated by 
  196. pressing CTRL-BACKSPACE while in the orbital prediction mode.  Orbital 
  197. predictions displayed on the screen can be logged to a file for future 
  198. reference or printing using this feature.  Once activated, the current 
  199. screen and all subsequent orbital prediction screens are copied to a file 
  200. named "satname.txt".  Invalid filename characters are replaced with an
  201. underscore ('_') character.
  202.  
  203. The file logging feature is de-activated by pressing CTRL-BACKSPACE once 
  204. again, or by exiting the orbital prediction mode.  If it is re-activated 
  205. once again at a later time for the same satellite, the orbital data will be
  206. appended to the older data using the same file name.  The file may be
  207. edited at a later time using the DOS text editor and printed on a printer.
  208.  
  209.  
  210. * CONTRIBUTIONS WELCOMED *
  211. ==========================
  212. A considerable amount of time and effort has gone into the development
  213. of PREDICT.  If you find this software useful, a reasonable contribution
  214. would be appreciated.  Not only would a contribution help compensate for the
  215. hard work and long hours that have gone into the development of this accurate
  216. and easy-to-use satellite orbital prediction program, but your financial
  217. support would also serve as encouragement for the author to pursue enhanced
  218. versions of PREDICT and other related software.
  219.  
  220. Checks should be made payable in US funds to the author and sent to the
  221. following address:
  222.  
  223.     John A. Magliacane, KD2BD
  224.     1320 Willow Drive
  225.     Sea Girt, New Jersey 08750-2315
  226.  
  227. Comments and suggestions regarding PREDICT are also welcomed with your
  228. payment.  
  229.  
  230. Thank you!
  231.  
  232. 73, de John, KD2BD